home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / ARCHIVE / RECOMMT.ZIP / RECOM105.DOC < prev   
Encoding:
Text File  |  1990-04-27  |  12.1 KB  |  278 lines
  1.  
  2.  
  3.  
  4.  
  5.         ReComment - a .ZIPfile Comment Processor               4/27/90
  6.         Version 1.05 - Copyright 1990, Michael C. Loewen
  7.         -----------------------------------------------------------------
  8.            ReComment is a utility which allows you process .ZIP file
  9.         comments, in a manner which is particularly useful to BBS
  10.         operators.  I wrote this program to replace a somewhat cumbersome
  11.         procedure on my BBS, involving removing/replacing .ZIP comments
  12.         and timestamping, which was being performed by several different
  13.         utilities.  ReComment allows me to perform all these operations
  14.         in 1 step, while also allowing me to log .ZIP comments to a file
  15.         for later viewing.  With more and more sysops adding comments to
  16.         the .ZIP files on their systems, it's interesting to note from
  17.         where the files uploaded to your system are coming.
  18.  
  19.         ReComment allows you to perform the following operations on
  20.         a .ZIP file:
  21.  
  22.         1. Remove a comment from a .ZIP.
  23.         2. Add a comment to a .ZIP with no existing comment.
  24.         3. Substitute a new comment for an existing comment.
  25.         4. Copy comments to a logfile, for later inspection.
  26.         5. Change the .ZIP timestamp to that of the most recent file
  27.         within the .ZIP.
  28.  
  29.                               Command Line Options
  30.                              ----------------------
  31.  
  32.         -n
  33.              do NOT remove existing comment.  This option overrides -s.
  34.  
  35.         -o
  36.              Change .ZIP file timestamp to that of the most recent file
  37.              within the .ZIP
  38.  
  39.         -l LOGFILE
  40.              Log existing comments to a text file, LOGFILE.  Comments are
  41.              appended to an existing file, or a new file is created if
  42.              the specified file does not exist.
  43.  
  44.         -s COMMENTFILE
  45.              Substitute (add) a comment contained in COMMENTFILE to
  46.              the .ZIP.  If there is no existing comment in the .ZIP, the
  47.              new comment is added.  If there IS an existing comment, it
  48.              is replaced.  COMMENTFILE may be created with any ASCII or
  49.              ANSI editor.  Note: if the replacement comment is the SAME
  50.              as the old comment, it will not be replaced or logged.
  51.  
  52.            You can use wildcards on the command line for the .ZIP files.
  53.         Command line options may be used in any order, with the following
  54.         restrictions:
  55.  
  56.         1. If -l is used, the log file name must follow it.
  57.         2. If -s is used, the comment file name must follow it.
  58.         3. The first argument which does not begin with a '-' is assumed
  59.         to be a .ZIP filename, along with everything following it.
  60.  
  61.  
  62.  
  63.  
  64.                                 Program Defaults
  65.                                __________________
  66.  
  67.            Program operation defaults to that of a simple comment
  68.         stripping utility:
  69.  
  70.         1. Remove existing comment.
  71.         2. Do not log comments.
  72.         3. Maintain the .ZIP file timestamp.
  73.  
  74.                            Environment Variable RECOM
  75.                           ----------------------------
  76.  
  77.            If you prefer, you can specify a default set of options in an
  78.         environment variable, RECOM.  Set RECOM equal to the options you
  79.         wish to use, exactly as you would use them on the command line,
  80.         with one restriction: you may not specify .ZIP files in the RECOM
  81.         variable.  Note: if you elect to use the RECOM variable, and also
  82.         specify the same options on the command line, the command line
  83.         options will override the variable settings.
  84.  
  85.            Please note that ReComment does NOT process comments attached
  86.         to individual files within the .ZIP: it only works with comments
  87.         attached to the end of the .ZIP.  Also, ReComment does not, at
  88.         this time, support self-extracting .ZIP files.  This will be
  89.         implemented in a later version.
  90.  
  91.                                     Examples
  92.                                    __________
  93.  
  94.            ReComment allows a certain flexibility in its operation, by
  95.         using the options in various combinations.  Some examples are:
  96.  
  97.         Command Line                            Operation
  98.  
  99.         recom *.zip                   Removes comment, maintains .ZIP
  100.                                       timestamp.
  101.  
  102.         recom -o *.zip                Removes comment, sets .ZIP
  103.                                       timestamp to most recent file
  104.                                       in .ZIP.
  105.  
  106.         recom -n -o *.zip             Changes .ZIP timestamp, only.
  107.  
  108.         recom -l logfile *.zip        Remove comment, log it to logfile.
  109.  
  110.         recom -s cfile *.zip          Replace comment.
  111.  
  112.         recom -l logfile -s cfile *.zip
  113.                                       Replace comment, log old comment.
  114.  
  115.         recom -n -l logfile *.zip     Log existing comment, do not
  116.                                       remove.
  117.  
  118.  
  119.  
  120.  
  121.                                     BBS Hints
  122.                                    -----------
  123.  
  124.            ReComment can be used on a BBS in several ways.  On my system
  125.         (PCBoard 14.2), with ProDoor 3.1, I made an entry in the
  126.         PROUTEST.BAT file, to automatically process .ZIP files when they
  127.         are uploaded.  Such an entry might look like this:
  128.  
  129.         rem -- replace comments in uploads; RECOM is from RECOM105.ZIP
  130.         chkpath recom %0 >>%1
  131.         recom -o -s c:\pcb\icslabel -l c:\pcb\cmntfile %2\*.zip >>%1
  132.  
  133.            An alternative, and possibly more useful method, would be to
  134.         make an entry in your EVENT.SYS file, to process your upload
  135.         directory on a daily basis.  This entry might look like this:
  136.  
  137.         recom -o -s c:\pcb\icslabel -l c:\pcb\cmntfile c:\upload\*.zip
  138.  
  139.  
  140.                               Software Availability
  141.                              -----------------------
  142.  
  143.            The latest version of this software is available on several
  144.         systems, among them:
  145.  
  146.         The ICS Round Table - State College, PA  (814) 231-2568
  147.         The Magnetic Bottle - State College, PA  (814) 231-1345
  148.  
  149.            I can be reached (Mike Loewen) on either of these systems for
  150.         questions, comments, suggestions, etc..  I can also be reached
  151.         through the RIME (RelayNet International Message Exchange)
  152.         Shareware conference.
  153.  
  154.            Many thanks to Bill Mertens, sysop of the Magnetic Bottle, for
  155.         testing the software and his many helpful suggestions, and to
  156.         Frank Maczaczyj, sysop of the Random Access BBS (814-371-5881)
  157.         for his help in testing.
  158.  
  159.            If you find this program to be useful, any contributions will
  160.         certainly be welcome, in order to support the continued
  161.         development of this, and other software.  Contributions may be
  162.         sent to:
  163.  
  164.                                 Michael C. Loewen
  165.                                 RD4, 461 Plum St.
  166.                               Bellefonte, PA  16823
  167.  
  168.  
  169.            I strive to develop a quality product, and I believe that this
  170.         software is fully functional as stated in the documentation.
  171.         However, it is not possible to test the software in all
  172.         situations, and there may be something lurking deep down which
  173.         might surface unexpectedly.  Should you discover a defect in the
  174.         program, please contact me on the ICS Round Table, so that I
  175.         might correct the problem.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.                                  Version History
  182.                                 -----------------
  183.  
  184.         1.04 (03/25/90) - initial public release.
  185.  
  186.         1.05 (04/27/90) - bug fix.  Changed the manner in which comments
  187.         and log files are searched for CTRL-Z characters: comments with
  188.         multiple CTRL-Zs were sneaking through.  Also found a logic flaw
  189.         which would cause ReComment to ignore a request for timestamp
  190.         change in .ZIP files with no comment attached.
  191.  
  192.            Now, for the legal stuff:
  193.  
  194.                                    Disclaimer:
  195.                                 -----------------
  196.            The author makes no warranties, expressed or implied, as to
  197.         the quality or performance of this program.  Your use of this
  198.         program constitutes your release of the author from liability or
  199.         litigation for any indirect or consequential damages arising from
  200.         the use of this program or its associated files.
  201.  
  202.            In no event will I be liable to you for any damages, including
  203.         any lost profits, lost savings or other incidental or
  204.         consequential damages arising out of your use of inability to use
  205.         the program, or for any claim by any other party.
  206.  
  207.                                 Copyright/License
  208.                                -------------------
  209.         This document and the program file RECOM.EXE ("the software") are
  210.         copyrighted by the author.  The copyright owner hereby licenses
  211.         you to:
  212.  
  213.         1. use the software;
  214.         2. make as many copies of the program and documentation as you
  215.         wish;
  216.         3. give such copies to anyone;
  217.         4. distribute the software and documentation via electronic
  218.         means.
  219.  
  220.            No fee may be charged for this software, beyond the cost of
  221.         the media.  Also, the software may NOT be distributed as part of
  222.         any software package for sale, unless specific permission is
  223.         first obtained in writing from the author.
  224.  
  225.            Your use of the program constitutes your acceptance of the
  226.         terms and conditions stated above.  No copy of the software may
  227.         be distributed or given away without this document, and this
  228.         notice must not be removed.
  229.  
  230.         -----------------------------------------------------------------
  231.  
  232.         ReComment - a .ZIPfile Comment Processor               4/27/90
  233.         Version 1.05 - Copyright 1990, Michael C. Loewen
  234.  
  235.  
  236.  
  237.  
  238.          ----------------end-of-author's-documentation---------------
  239.  
  240.                          Software Library Information:
  241.  
  242.                     This disk copy provided as a service of
  243.  
  244.                            Public (software) Library
  245.  
  246.          We are not the authors of this program, nor are we associated
  247.          with the author in any way other than as a distributor of the
  248.          program in accordance with the author's terms of distribution.
  249.  
  250.          Please direct shareware payments and specific questions about
  251.          this program to the author of the program, whose name appears
  252.          elsewhere in  this documentation. If you have trouble getting
  253.          in touch with the author,  we will do whatever we can to help
  254.          you with your questions. All programs have been tested and do
  255.          run.  To report problems,  please use the form that is in the
  256.          file PROBLEM.DOC on many of our disks or in other written for-
  257.          mat with screen printouts, if possible.  PsL cannot debug pro-
  258.          programs over the telephone, though we can answer questions.
  259.  
  260.          Disks in the PsL are updated  monthly,  so if you did not get
  261.          this disk directly from the PsL, you should be aware that the
  262.          files in this set may no longer be the current versions. Also,
  263.          if you got this disk from another vendor and are having prob-
  264.          lems,  be aware that  some files may have become corrupted or
  265.          lost by that vendor. Get a current, working disk from PsL.
  266.  
  267.          For a copy of the latest monthly software library newsletter
  268.          and a list of the 2,000+ disks in the library, call or write
  269.  
  270.                            Public (software) Library
  271.                                P.O.Box 35705 - F
  272.                             Houston, TX 77235-5705
  273.  
  274.                                 1-800-2424-PSL
  275.                                  MC/Visa/AmEx
  276.  
  277.                           Outside of U.S. or in Texas
  278.                           or for general information,
  279.                               Call 1-713-524-6394
  280.  
  281.                           PsL also has an outstanding
  282.                           catalog for the Macintosh.
  283.  
  284.